Organisation AI Sources de recette · paquets privés

Guides · Édition du 14 novembre 2026

Sauvegarder et restaurer

Une sauvegarde complète associe la base aux pièces jointes et justificatifs. L’export JSON du Studio et la copie automatique avant migration ne remplacent pas cette archive.

Créer une archive SQLite

L’outil tools/local_backup.py est disponible depuis une copie autorisée des sources ; aucune commande Python n’est promise à l’intérieur du ZIP ou du DMG. Il utilise la bibliothèque standard Python.

  1. Arrêter proprement toutes les instances qui utilisent cette base. Vérifier l’arrêt avec l’administrateur.
  2. Choisir un dossier de sauvegarde existant et un nom de fichier inédit.
  3. Exécuter create, puis verify. Le drapeau --application-stopped atteste l’arrêt par l’opérateur ; il ne l’effectue pas.
python3 tools/local_backup.py create --database /chemin/donnees/organization.db --output /chemin/sauvegardes/sauvegarde.zip --application-stopped
python3 tools/local_backup.py verify /chemin/sauvegardes/sauvegarde.zip

L’archive contient organization.db et les dossiers files, receipts et collections s’ils existent, avec manifeste, tailles et empreintes. Sauvegarder un dossier collections existant n’active aucune fonction. L’outil refuse liens symboliques, fichiers spéciaux et journal SQLite non vide. Ne jamais supprimer un WAL pour forcer la sauvegarde. Limites : 20 Gio et 100 000 fichiers. Un fichier d’archive existant n’est pas écrasé.

Conserver la copie

L’archive n’est pas chiffrée par l’outil. Elle peut contenir conversations, pièces, coordonnées et clés enregistrées dans la base. Faire une copie chiffrée indépendante du poste, vérifier sa relecture et fixer une rotation adaptée. Aucune tâche automatique ni destination cloud n’est créée par ces commandes.

Restaurer dans un nouveau dossier

Utiliser une version compatible et une machine de test protégée. Le dossier destination doit ne pas exister, même vide.

python3 tools/local_backup.py restore /chemin/sauvegardes/sauvegarde.zip --destination /chemin/reprise-neuve

Les chemins de pièces sont adaptés à la destination. Le serveur n’est pas démarré par restore. Avec les sources, pour un contrôle isolé sans tâches automatiques :

ORGIA_DB=/chemin/reprise-neuve/organization.db ORGIA_SCHEDULER=0 python3 desktop.py

Pour une restauration vers un programme empaqueté, l’opérateur définit ORGIA_DB dans l’environnement de son lancement. Ne pas déplacer l’archive sur une base active. Ne pas activer SMTP, IA ou tâches automatiques pendant l’exercice : la sauvegarde peut contenir des actions en attente et des liens invités valables.

Vérifier connexion, nom de l’organisation, droits, conversation et téléchargement d’une pièce. Un exercice Linux → programme Mac a réussi avec données fictives ; cela ne mesure pas le délai de reprise de chaque installation client. Pour PostgreSQL, cet outil ne convient pas : préparer dump/restauration PostgreSQL et copie cohérente des pièces séparément.

Documentation préparée pour publication. Logiciel et accès web en recette privée ; aucun accès public ouvert par ce portail.